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COBOL (on Tape) Specifications 
IBM 1401 


This publication is intended for programmers who have a 
basic knowledge of cobol programming. It includes the addi- 
tional specifications necessary to write a cobol program for 
the ibm 1401 Data Processing System. 

Specific examples show how many cobol statements are 
coded. A general explanation of these statements is also given. 

A sample problem shows complete entries for the identifi- 
cation, ENVIRONMENT and DATA DIVISIONS. 




Preface 


This publication partially describes the specifications 
for writing a 1401 cobol program to be processed by an 
ibm 1401 with at least 4,000 positions of core storage. 
It supplements the ibm cobol General Information 
Manual, Form F28-8053, which describes the cobol 
language as it applies to ibm computers. The manual 
includes many details about* the cobol language that 
are not included in this publication. 

The 1401 cobol programmer should also be familiar 
with the material contained in the following Systems 
Reference Library publications: 

IBM 1401 System Operation Reference Manual, Form 
A24-3067 

Autocoder (on Tape) Language Specifications and 
Operating Procedures IBM 1401 and 1460, Form 
C24-3319 

Input/Output Control System Specifications and 
Operating Procedures for IBM 1401 and 1460, 
Form C24-1462 

Operating information for this version of 1401 
cobol is in COBOL (on Tape) Operating Pro- 
cedures IBM 1401, Form C24-3146. 

Since the ibm 1401 Data Processing System was an- 
nounced, the ibm 1401 Symbolic Programming System 


has been widely used. This system is essentially a one- 
for-one coding system in which the programmer writes 
one symbolic instruction for each actual machine- 
language instruction needed to solve a given problem. 
This system relieves the programmer from the burden 
of remembering machine-language operation codes 
and machine addresses. 

The 1401 Autocoder was subsequently developed to 
permit the programmer to use macro instructions that 
incorporate common routines automatically. The 1401 
Input/Output Control System (IOCS) has been in- 
cluded in Autocoder to provide standard routines for 
getting data into and out of the machine. 

The cobol language permits programming in terms 
that describe the problem, rather than in terms that 
describe the machine used to solve it. The general 
language specifications (with a few minor exceptions) 
remain the same for all computers. 

To write a complete cobol program for the 1401, the 
reader must be familiar with the information presented 
in the cobol General Information Manual as well as 
the material in this publication. 


This publication, C24-1492-2, is a major revision of C24-1492-1 
and obsoletes it and prior editions. In addition to incorporating 
information released in Technical Newsletters N24-0259 and 
N21-0033, significant changes have been made. A section on 
Programming Considerations has been added. 


Copies of this and other IBM publications can be obtained through IBM Branch Offices. 
A form is included at the back of this manual for readers’ comments. If this form has 
been removed, address comments to: IBM Corporation, Product Publications, Dept. 245, 
Rochester, Minn. 55901. 
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The COBOL Language 


The programmer’s responsibility in preparing a cobol 
program is to: 

1. Identify the program. 

2. Specify the features and devices of the ibm 1401 
Data Processing System that will be used to compile 
and execute the resultant machine-language object 
program. 

3. Describe the data to be processed. 

4. State the procedure to process the data. 

The programmer uses the characters, words, and ex- 
pressions that make up the cobol language. He writes 
them according to a standard reference format that is 
outlined on the cobol program sheet (Form X28-1464). 
This standard coding sheet is used with all ibm cobol 
systems to record the source program. 

The cobol source program card deck is punched 
from these coding sheets. These cards make up the 
cobol source program card input to the 1401 cobol 
processor. 

The Cobol Processor 

The cobol processor is itself a program. It compiles 
an object program in 1401 Autocoder language from 
the cobol source statements. The Autocoder processor 
assembles the machine-language object program from 
the object program in Autocoder as shown in Figure 1. 

Machine Requirements 

The 1401 cobol processor can compile an object pro- 
gram for any ibm 1401 system that has at least 4,000 
positions of core storage. However, to process the cobol 
source program, the 1401 must have at least: 

• 4,000 positions of core storage 

• Four ibm magnetic-tape units 

• ibm 1403 Printer, Model 2 

• ibm 1402 Card Read-Punch 

• Advanced Programming Feature 

• High-Low-Equal Compare Feature 

• Sense Switches 

The 1401 on which the ob ject program is to be exe- 
cuted must have: 

1. Sufficient core storage to contain the program pro- 
duced by the cobol processor. If the object program 
requires more than the available core-storage capac- 
ity, either the program must be executed in sections 
(overlays) or the job must be divided into multiple 
runs. 

Note: This requirement is a significant consider- 
ation when planning to implement COBOL on a 
system with 4000 positions of core storage. 



Figure 1 . cobol Compiling and Assembly Process 

2. The object machine must have the input and output 
units defined in the file-control paragraph. 

3. Advanced Programming Feature. 

4. High-Low-Equal Compare Feature. 

5. Sense Switches when they are referred to in the 
special-names section. 

6. Multiply-Divide Feature if any of these entries ap- 
pears in the procedure division of the cobol source 
program: 

a. multiply verb. 

b. divide verb. 

c. compute verb when either /,*, or ** is used as 
the operator. 
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IBM 1401 COBOL Programming 


The 1401 cobol source program has four major divi- 
sions. Each division has its own set of statements which 
are written according to the rules established for the 
cobol language, as described in the IBM COBOL Gen- 
eral Information Manual, Form F28-8053. These divi- 
sion statement sets must be arranged for presentation 
to the 1401 cobol processor in this order: 

IDENTIFICATION DIVISION. 

ENVIRONMENT DIVISION. 

DATA DIVISION. 

PROCEDURE DIVISION. 

Write the identification division entries as de- 
scribed in the IBM COBOL General Information 
Manual. 


names to standard names for actual machine devices, 
equates condition names to standard names for the 
status of actual machine switches, and equates Auto- 
coder names to cobol names. 

Source-Computer Paragraph 

Reference Format 


SOURCE-COMPUTER. IBM-1401 


MEMORY SIZE < 

f 4000 
8000 
12000 

> CHARACTERS 


( 16000 J 



Environment Division 

In this part of the cobol source program, the program- 
mer specifies the physical characteristics of the par- 
ticular ibm 1401 system(s) to be used to compile and to 
execute the object program. 

The environment division has two major sections, 
each of which has a fixed section name: configuration 
and input-output. 

The 1401 cobol presentation format for this is: 
environment division. 

CONFIGURATION SECTION. 

SOURCE-COMPUTER. 

OBJECT-COMPUTER. 

SPECIAL-NAMES. 

INPUT-OUTPUT SECTION. 

FILE-CONTROL. 


Configuration Section 

The configuration section has three paragraphs: The 
source-computer paragraph names and describes the 
1401 that will compile the object program from the 
cobol source statements. 

The object-computer paragraph names and de- 
scribes the 1401 that will execute the object program. 
The special-names paragraph equates mnemonic 




NO-RELEASE 




NO-FRINT-STORAGE 



General Description: This paragraph names the com- 
puter that will compile and assemble the object pro- 
gram. It is the computer in which the ibm 1401 cobol 
processor program compiles a machine-oriented sym- 
bolic program ( 1401 Autocoder) from the problem- 
oriented cobol source program and assembles the 
actual machine-language program. 


r 

4000 

1 

MEMORY SIZE < 

8000 
12000 
( 16000 

> CHARACTERS 


General Description: This statement tells the cobol 
processor how much core storage (memory) is avail- 
able for use during the compiling and assembling 
operation. If this statement is omitted, the actual ma- 
chine core-storage size will be used. If the clause is 
included, the specified machine size will be used un- 
less it is greater than the actual machine core-storage 
size. 


NO-RELEASE 



NO-PRINT-STORAGE 




The appropriate clause(s) must be included if the 
source computer does not have the read-punch release 
or print-storage features. 
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Object-Computer Paragraph 

Reference Format 


OBJECT-COMPUTER. 


IBM-1401 


j^ASSIGN OBJECT-PROGRAM TO TAPeJ 

}' 


MEMORY SIZE 


[- 


( 4000 ) 

5 ( CHARACTERS 
* 16000 

ADDRESS integer 1 THRU 


( 4000) 

) 8000 l 
} 12000 ( 
(16000 ) 


NO-OVERLAP 


0 


NO-PRINT-STORAGE 


] 


General Description: The object-computer paragraph 
describes the computer that will execute the object 
program. The “object-computer, ibm- 1401” state- 
ment defines an ibm 1401 with 16,000 characters, the 
processing-overlap feature, and input/output units 
required for the files defined in the file-control 
paragraph. If the object machine has fewer than 
16,000 positions of storage and/or no overlap, and/or 
no print storage, the appropriate clauses must be in- 
cluded in the source program. It also permits the pro- 
grammer to specify which input device will read the 
object program into storage before it is executed. 

[assign OBJECT-PROGRAM TO TAPE 


General Description: This statement directs the proc- 
essor to put the object program on magnetic tape. If 
this statement is included in the cobol source pro- 
gram, a tape unit is designated as the input device 
that will read the object program into storage. If 
the statement is omitted, the object program will be 
punched in cards and the ibm 1402 Card Read-Punch 
will be the input: device. 


General Description: This clause tells the processor 
how many positions of core storage are available in 
the object machine and the starting core-storage ad- 
dress of the object program. 

If the programmer wishes the program to start at 
any location other than 333, he can use the address 
integer-1 thru option and write the numerical ad- 
dress of this location in the integer-1 portion. This 
number should not be less than 333. The number 
following thru specifies the last core-storage position 
that can be used for the object program. 

If the memory size statement is omitted from the 
cobol source program, the processor assumes that 
the object computer has 16,000 positions and starts 
the object program at core-storage location 333. 

Qno-overlap] 

General Description: The no-overlap option must be 
included only if the object computer does not have 
the processing overlap feature. 

When the overlap feature is used, an alternate area 
must be specified for tape input files with form-1 
records. 

j^ NO-PRINT-STORAGE ^j . 

General Description: This clause must be included if 
the object computer is not equipped with the print- 
storage feature. 

Example: Figure 2 shows a sample object-computer 
paragraph. 


§ 

r 

j 

A | 8 

8 ! 12 16 20 24 28 32 36 40 44 46 92 

“ 

OATF&T-GGMPUT.LR-, 


, , , A&SI6M OFtf EOT- PRA&RAM ,TA ,T,AP,K 


, , , HF MORN, SIZ,£, AfrDRFAS, MAX. THRU l&OOO 


, ■ , NQ-QVERLAR., ^..l 


Figure 2. object-computer Paragraph 


MEMORY SIZE 


( 4000 1 

hiooo } CHARACTERS 

(16000 ; 

ADDRESS integer-1 THRU 


4000 

8000 

12000 

16000 
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Special-Names Paragraph 

Reference Format 

SPECIAL-NAMES . 

device-name-1 IS mnemonic-name-1 f” device-name-2 IS 


For the 1403-CT device name, n specifies which 
channel in the carriage tape terminates a particular 
carriage skip. It can be any number from 1 to 12. This 
name is used with the advancing option of the write 
verb (see Procedure Division). If n is not coded, the 
processor assumes that the skip is to channel 1. If n is 
coded, there must be a space between it and the device 
name as in 1403-CT, 3. 


mnemonic-name-2 


■] 


switch-name-1 


j^ON 


STATUS IS condition-name-1 


] 


j^ OFF STATUS IS condition-name-2 


] 




switch-name-2 




[ 


AUTOCODER-name IS COBOL-name 


] 


r 


L 


AUTOCODER-name IS COBOL-name AUTOCODER . 


A 


]]• 


General Description: This statement enables the pro- 
grammer to write Autocoder statements that refer to 
cobol data-names and procedure-names (see Enter). 

If an Autocoder name is used to refer to an area 
that has been defined by a cobol statement, the 
cobol name must be equated to the Autocoder name. 

Example: If TOTALS is a cobol name used to define 
a cobol area and the symbol TOTLS is used in an 
Autocoder statement to refer to the same area, the 
statement shown in Figure 3 must appear in the 
special-names section of the cobol program. 


General Description: This paragraph equates mne- 
monic-names to the standard names for actual ma- 
chine devices, equates Autocoder-names to cobol- 
names, and equates condition-names to the status of 
actual machine switches. 


1 A 
7 8 

| B 

i>2 16 20 24 28 32 36 

40 

44 

48 

52 














Device-Names 

General Description: The standard device-names for 
the 1401 signal the cobol processor which devices 
are available in the object computer. They are writ- 
ten with mnemonic-names the programmer has used 
to refer to them in the procedure division. The 1401 
device-names are: 


Device-Name 
1402-R, n 

1402- P, n 

1403- P 
1403-CT, n 


Actual IBM 1401 Device 
1402 Card Reader 

1402 Card Punch 

1403 Printer 

1403 Printer Carriage 


Figure 3. Equating and Autocoder-Name to a COBOL-Name 


A symbol used as an Autocoder name must meet 
these requirements: 

1. It must be five characters long. 

2. It must begin with an alphabetic character. 

3. It cannot contain a special character. 

4. A blank cannot appear within the symbol. 

The cobol name must be a non-qualified proce- 
dure-name or data-name. It cannot be a condition- 
name. 


For the 1402-R and 1402-P device-names, n is a digit 
specifying the stacker into which a card is to fall. For 
the card reader it must be a 0 (normal read), 1 (read 
select), or 2 (common). For the card punch it must be 
0 (normal punch), 4 (punch select), or 8 (common). 
If one of the digits is invalid or is not included with a 
1402 device-name, the processor assumes that the 
stacker desired is 1 for a read operation and 4 for a 
punch operation. If n is coded, there must be a space 
between it and the device-name as in 1402-R, 1. 

Punched-card input and output devices should not 
be used with both the display and write verbs in the 
same program. The same restriction applies to using 
these devices with both the accept and read verbs. 


Switch-Names and Conditions 

General Description: A switch-name is written followed 
by the condition-names used to identify on status 
and off status. 

The standard 1401 switch-names are: 


Switch-Name 
1403-P-CB 
1403-P-C9 
1403-P-CV 
1401-SS x 


Indicates 

Printer Carriage Busy 

Sense Carriage Tape Channel 9 

Sense Carriage Tape Channel 12 (Overflow) 

Sense Switch 


The x in 1401-SS x is the actual letter that repre- 
sents a specific 1401 sense switch. This must be a 
letter within the range A-G. There must be at least 
one space between 1401-SS and the letter used for x. 
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Figure 4. special-names Paragraph 

The status of these switches may be interrogated 
by expressions in the procedure division that use 
condition-names . 

Example: Figure 4 shows a sample special-names 
paragraph written for a 1401. 

Input-Output Section 

The input-output section has two paragraphs: 

The file-control paragraph names each file, identi- 
fies its input or output medium, and assigns it to one or 
more input-output devices. 

The i-o-control paragraph is a deferred feature for 
1401 cobol and thus can not be included in a 1401 
cobol source program. See Deferred Features. 

File-Control Paragraph 

Reference Format 

FILE-CONTROL . SELECT file-name-1 

ASSIGN TO device-name-1 
r RESERVE j 1 l ALTERNATE AREA[S] 

L < NO \ 

^ SELECT 

General Description: This paragraph names each file 
used in the source program, identifies its media, and 
assigns it to an input or output device. It also permits 
the programmer to specify an alternate input-output 
area for magnetic tape files if the 1401 has overlap 
processing. 

SELECT file-name-1 

General Description: Each file to be processed by the 
read or write verbs in the procedure division must 
be named in a select file-name entry. This file-name 
must be unique within the source program and must 
be described by a file-description entry in the data 
division of the source program. 

Example (Figure 5): 
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Figure 5. select 


ASSIGN TO device-name-1 


General Description: Each file must be assigned to an 
input or output device-name. The 1401 device-names 
that are valid in the file-control paragraph are: 


Device-Name 
TAPE(S) u a 
1402-R, u 

1402- P, u 

1403- P 


Description 
Magnetic Tape Unit 
Card-Reader 
Card-Punch 
Printer 


Magnetic-Tape Device-Names 

For magnetic-tape files, tape(s) is the device-name. It 
indicates that the file is to be assigned to a tape unit. 
The u specifies the particular unit to be assigned. It can 
be any digit from 1 to 6. The a specifies that an alter- 
nate unit is to be assigned. It can be any digit from 1 
to 6, but should not be the same digit that is used for u. 
The same tape unit (or alternate tape unit) should not 
be assigned more than once in a cobol source program. 
There must be a space between tape(s) and u and be- 
tween u and a. (If the user specifies an invalid u, the 
processor substitutes the value 6.) 

Example (Figure 6 ) : 


I A 

V e 

;b 

12 16 20 24 28 32 36 

40 

44 

48 
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Figure 6. assign 

Punched-Card Device-Names 

The Punched-Card devices that are valid in the file- 
control paragraph are the card reader, the card punch, 
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and the printer. Their device-names are written as de- 
scribed in Special-Names Paragraph. 

RESERVE j ^ | ALTERNATE AREA[S] J . 

General Description: This statement reserves one or no 
alternate area for a magnetic-tape file. One alternate 
area may be specified only if the object machine has 
the overlap feature. 

Example (Figure 7): 


§ A |B 

7 6 !l2 16 20 24 32 5ft 40 44 48 

_ i i i iRiE.SiEiRNiEi A ALTiEiRhlAfiEi AREA- . ■ i i ■ i i i i ■ j _ _l i i i j 

■ i i i i i i i i i i ) i i j i i i j ' i i i i '' ' i i '' ' i i i i i i i i i i i i 

Figure 7. reserve 


Figure 8 shows a sample file-control paragraph. 



Added Elective Elements — Environment Division 

The memory size option of the source-computer para- 
graph is not contained in the cobol General Informa- 
tion Manual, but is provided in the 1401 cobol proc- 
essor as it has been described in this publication. 

Deferred Elements — Environment Division 

Several elements are described in the cobol General 
Information Manual that are not contained in this ver- 
sion of 1401 cobol processor. These should not be 
coded in the environment division entries for a 1401 
cobol program. They are stated here for reference: 

1. The entire i-o-control paragraph (elective cobol 
element). 

2. The optional option of the file-control paragraph. 

3. The multiple reel option in the file-control 
paragraph and all other features that provide for 
automatic assignments of tape units for a file. 

4. The entire copy option. (The library tape for the 
1401 cobol processor does not presently support the 
copy feature.) 

5. The renaming clause in the file-control para- 
graph. 


Figure 8. file-control Paragraph 


10 



Data Division 


IBM 1401 COBOL Tape Labels 

The 1401 cobol processor provides for ibm 1401 cobol 
tape labels. These labels identify the file and specify 
the number of records in the file, the date it was cre- 
ated, and the length of time it must be kept. Two 
labels, a header and a trailer', are required for each 
labeled file. 

IBM Header Labels 

A header label is the first record of each reel of a file. 
It identifies the tape. The header label format is shown 
in Figure 9. 


FIELD NO. 

POSITION 

CONTENTS 

FIELD NAME 

EXAMPLE 

1 

1-4 

1HDR 

Header Label 

IHDRb 


5 

Blank 

Identifier 


2 

6-10 

5 Digits 

Tape Serial 
Number 

12345 

3 

11-15 

5 Digits 

File Serial 
Number 

54321 

4 

16 

_ 

Reel Sequence 

-002b 


17-19 

3 Digits 

Number 



20 

Blank 



5 

21-30 

10 Characters 

File Identification 
Name 

PAYRLMASTR 

6 

31-35 

5 Digits 

Creation Date 
(00-99)(00 1-366) 
Year Day 

63203 

7 

36 

_ 

Retention Cycle 

-007b 


37-39 

3 Digits 

(000-365) 



40 

Blank 



8 

41-80 

Not used 




Figure 9. cobol Header Label Format 
Header Label Identifier 

These four characters indicate that the information con- 
tained in the record is the header label of a tape reel. 

Tape Serial Number 

These five digits identify the reel of tape within an in- 
stallation. Each reel of tape should be given a tape 
serial number as soon as it is received at the installa- 
tion. IOCS routines do not affect the tape serial num- 
ber in a tape label. 

File Serial Number 

These five digits indicate a particular application or job 
number within an installation. 


Reel Sequence Number 

These three digits identify the reels in cases where mul- 
tiple reels are needed for a specific job or application. 
The first reel is numbered 001 unless the user specifies 
another number. 

File Identification Name 

These ten characters identify the file. For example, 
payrlmastr identifies the tape as the payroll master 
file. 

Creation Date 

These five digits contain the date on which the file was 
written originally. The two high-order digits indicate 
the year (00-99), and the remaining three digits indi- 
cate the nth day of that year (001-366). 

Retention Cycle 

These three digits indicate the number of days the file 
is to be kept after the date the file was originated. Files 
should be preserved until all output data produced 
from them has been used successfully as new input. 
This ensures that any file that requires this file as input 
can be reconstructed if necessary. 

Header labels provide for a 365-day maximum reten- 
tion cycle. If the file must be kept indefinitely, the pro- 
grammer can specify this by putting the digits 99 in the 
two high-order positions of the creation-date field. 

IBM 1401 COBOL Trailer Labels 

The last information record in a tape reel is a trailer 
label. It indicates that the reel currently being proc- 
essed is the last reel of a file or that more reels must be 
processed. Trailer labels are written after the last rec- 
ord in the reel has been processed. 

The ibm cobol trailer label format is shown in Fig- 
ure 10. 


Field 

No. 

Posi- 

tions 

Contents 

Field Name 

Example 

1 

1-4 

"IEOF or 
IEOR" 

Trailer Label 
Identifier 

IEOF 


/ 5 

Blank 



2 

S 6-10 
1-80 

5 Digits 
Not used 

Block Count 

13430 


Figure 10. ibm 1401 cobol Trailer Label Format 


Trailer Label Identifier 

These four characters indicate that the information con- 
tained in the record is the trailer label of a tape reel. 
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Block Count 

This field contains the number of blocks contained in 
the reel. A count is developed during processing and is 
entered in the trailer label record. 


Record Formats for Tape Files 

Detailed information about record formats is presented 
in the publication Input/Output Control System: Speci- 
fications and Operating, Procedures for IBM 1401 and 
1460, Form C24-1462. General information is pre- 
sented in the following sections. Records for tape files 
may be as large as 999 characters. 

Form-1 Records 

Form-1 tape records are fixed-length, unblocked, with 
or without record marks. Fixed-length implies that all 
records in the file have the same number of characters. 
Unblocked means that one data record is contained in 
one tape record. A record mark ( 4 =) is a special char- 
acter written at the end of a data record to indicate that 
the preceding character is the last record character. If 
input records are form 1 but are to be written as out- 
put in form 2, or 4, they should have record marks. 
Otherwise the use of record marks is optional. Tape 
records are physically separated by a section of blank 
tape called an Inter-Record Gap (IRG). Figure 11 
shows an example of form-1 records with record marks. 

Figure 12 shows a form-1 record without record 
marks. 

Form-2 Records 

Form-2 records are fixed- length, blocked, with record 
marks, and with padding of short-length, blocks. 
Blocked means that more than one data record is con- 
tained in one tape record (two or more data records 
occupy the space between two interrecord gaps ) . Rec- 
ord marks must be used to separate the data records. 

Padding means that spaces (blanks) are used to fill 
the last block for a file if there are not sufficient data 
records to fill it. Thus, a fixed-length block will always 
contain the same number of characters, but a blank 


record will be substituted if there are not enough data 
records to fill the last block. 

Figure 13 shows a fixed-length, block tape record 
with record marks and padding. Each block contains 
four records. 

Form-3 Records 

Form-3 records (variable unblocked) are not permitted 
with 1401 cobol. 

Form-4 Records 

Form-4 tape records are variable-length, blocked, with 
record marks and a Record Character Count (RCC) 
field in each record, and a Block Character Count 
(BCC) field in each block. Variable-length implies that 
all the records in a file do not contain the same number 
of characters. 

Block Character-Count Field 

A four-character field at the beginning of each block 
contains a count of the total number of characters in the 
block (including the block character-count field itself). 
The BCC field has AB zone bits (ibm card code 12- 
punch) over the units position. This count is used to 
check wrong-length record conditions. 

Record Character-Count Field 

A record character-count field of three characters in 
each record contains a count of the number of charac- 
ters in that record, including the RCC field itself and 
the record mark. This field must be in the same relative 
position in each record (the character size of each Cl 
in Figure 14 is the same). Figure 14 shows the record 
format for a form-4 record. 


Note: When programming for form-4 or form-2 
tape records, the record entry must allow a position 
for the record mark. For output records, the record 
mark must be moved into the record area before the 
record is written. 


1 

* 

1 

* 

1 

* 

1 

R 

Record 1 

R 

Record 2 

R 

Record 3 

R 

G 


G 


G 


G 


Figure 11. Form-1 Record with Record Marks 
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R 

Record 1 

1 

R 

Record 2 

1 

R 

Record 3 

1 

R 

G 


G 


G 
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Figure 12. Form-1 Record without Record Marks 
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Figure 13. Form-2 Record with Record Marks 
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Figure 14. Form-4 Record 


Record Formats for Punched-Card Files 

Card Read-Punch Records 

Records of files assigned to the 1402-R and the 1402-P 
must be eighty characters long, unblocked, and may or 
may not have record marks in the 80th character posi- 
tion ( card column 80 ) . This is equivalent to the form-1 
record described previously for tape files. 

Printer Records 

Records of files assigned to the 1403-P must also have 
form-1 record format. For the 1403 printer the fixed 
record size must be equal to the number of print posi- 
tions on the printer (100 or 132). 


Data Division Language Specifications 

The data division of a cobol source program is divided 
into three major sections: 

FILE SECTION. 

WORKING - STORAGE SECTION. 

CONSTANT SECTION. 

The file section describes the; input and output files 
with respect to content and organizational format. It 
has two major subdivisions: the file-description entry 
that specifies the physical characteristics and organi- 
zation of the input and/or output data, and the record- 
description entry that describes the individual items 
contained in the file records. 

The working-storage section describes the areas of 
1401 core storage where intermediate results and other 
items are stored temporarily at: object-program execu- 
tion time. 

The constant section describes fixed items of data 
that remain unchanged during the running of the ob- 
ject program. A date, for example, might be a fixed 
item, or constant. 


The 1401 cobol presentation format for the data 
division is: 

DATA DIVISION. 

FILE SECTION. 

File-Description Entries and 
Record-Description Entries 

WORKING-STORAGE SECTION. 

Record-Description Entries 
CONSTANT SECTION. 

Record-Description Entries 


File-Description Entry 

General Description: A file-description entry must be 
written for each file to be processed by the object 
program. It includes specifications for the mode in 
which the file is recorded, the record and block size, 
label record information, and the names of the data 
records that make up the file. A value clause is re- 
quired when label records are standard. 

Reference Format 

FD file-name ^ RECORDING MODE IS mode^J 


[ 

[. 


BLOCK CONTAINS integer-1 


( RECORDtS] 

( CHARACTER^] 


}] 


RECORD CONTAINS [integer-2 TO] 


integer-3 CHARACTER^] 


LABEL RECORD[S] 


P 


{ } { 


] 


STANDARD 

OMITTED 


} 


VALUE OF data-name-1 IS literal data-name-2 IS 


L 

DATA RECORDtS] 


••]] 

I data-name-3 |da!a-name-4 , 


di 
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General Description: The level indicator identifies the 
beginning of the file-description entry and precedes 
the file name assigned by the programmer. 

Example (Figure 15): 


El ■— i 

| a ; B 

X I lit '8 20 24 28 32 58 40 44 46 

FiD l iR^YiRLiKA.SiTR llllllllllilliillllllllllll.il 

_1_J— I— L-t— I— L_L_ I— l_L-L- UL_1_X-I— L-L-L-J— 1— I— 1— 1— 1—1— I— LJL-l— LJ— I I l 


Figure 15. fd File-Name 


RECORDING MODE IS 1 


General Description: This clause specifies the mode in 
which the file is recorded. A 1 indicates the move 
mode, even-parity, recording mode 1 is the only re- 
cording mode implemented by 1401 cobol. 

If the recording mode clause is not included in 
the source program, the processor assumes recording 
mode 1. 

[block CONTAINS ,«,e e er-l ) §j™ R[s] [ ] 

General Description: This clause must be included if 
more than one data record is included in a tape rec- 
ord ( other than form 1 ) . It indicates the size of the 
block in records or characters. The size may be stated 
in terms of record(s) for form-1 or form-2 records 
where integer-1 is the number of data records in the 
block. 

The size must be stated in terms of character(s) 
for form-4 records where integer-1 is equal to or 
greater than the number of characters in the longest 
block of the file. This number includes the four- 
character block count field (BCC). See also Form-4 
Records. 


Example: The largest block in the payrlmastr file con- 
tains 500 characters plus the BCC field (Figure 16). 


§ A 

7 • 

6 

12 IS 20 24 20 32 30 40 44 40 


BLOCK, r.tQNTAI MS CHARACTERS , , , , 

i 11 

— 1 — 1 — 1 — 1 — 1 — 1 — 1 — L 1-1 till 1 I 1 1 1 i i i 1 1 i i i 1 l i i j II II J 


Figure 16. block contains 


RECORD CONTAINS [integer-2 TO] 


integer-3 CHARACTER^] 




General Description: The record contains clause may 
be used to specify the number of characters in the 
data records. Because the record description entries 
define the size of each data record, this clause is 
never necessary. However, if the programmer wishes 
to include it, integer-2 specifies the number of char- 
acters in the smallest record in the file, and integer-3 
specifies the number of characters in the largest 
record. 

Fixed-length records must be specified using in- 
teger-3 only. Variable-length records are specified by 
using both integer-2 and integer-3. 

Example: The records for a certain file are variable 
length. The smallest record size is 75 characters; the 
largest is 86 characters (Figure 17). 


§ A 

7 0 

B 

12 16 20 24 28 92 96 40 44 40 


RECORD .CONTAINS ,75, T.Q B.fc, CHARACTERS 

I 1 I 

LI 1 1.1.1 1 1 i„J 1 1 1_ J— 1 i 1 1-1 1 1 l-l 1 1. L 1-1 1 1 1 1 1 L-L-L 11 1 1_ 1 


Figure 17. record contains 

LABEL RECORD [S] \ IS f ^ STANDARD j 
l ARE > ( OMITTED ) 


General Description: This required clause states 
whether header and trailer tape label records are 
1401 cobol tape labels or omitted. The 1401 cobol 
processor can handle only 1401 cobol tape labels 
as described previously. For punched-card files the 
omitted option must be used. 

Example: Figure 18 shows a label record entry for a 
punched-card input file. 


§ A 

7 * 

1 B 

i*2 16 

20 24 26 92 96 40 44 

40 

, 

, !Labe,l, 

ARE rmi,T,T,F.n 


, , 

iii*i** 

111*111111 1--L * ll ll l 1111 « 111 1 tt 

J 1111 


Figure 18. label records 

Today's Date 

If standard label records are specified for output files, 
today’s date must be in core storage at object-program 
execution time. To enter the current date in the object 
program, insert a date card just ahead of the ex card 
produced by the Autocoder processor. The ex card is 
the last card in the object program. The format for the 
date card is: 


Card Columns 

Contents 

YR DAY 

1-5 

55cxxx 

40-46 

L005199 

47-53 

N000000 

54-60 

N000000 

61-67 

N000000 

68-71 

1040 
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VALUE OF data-name-1 IS literal-1 


data-name-2 IS 


■] 


General Description: The cobol programmer may 
specify the items of information that appear in the 
label records of tape files. These items must be sup- 
plied by using a value of clause if standard header 
labels are used. 

Data-name-1 and data-name-2 are the names of 
the fields contained in the header label record. Lit- 
eral-1 and literal-2 refer to the contents of the re- 
spective fields. Figure 19 is a chart showing the vari- 
ous data names and the lengths of their associated 
literals (an represents alphanumeric values and n 
represents numeric values). It also shows the rela- 
tionship between use of the entries and the type of 
label checking that will be applied to an input or out- 
put file. All entries in the chart, except those noted 
by one or two asterisks, are required. 

Example: Figure 20 shows how identification and a 
retention cycle of 286 days are supplied for an out- 
put file. 

DATA RECORD[Sl j data-name-3 ^data-name-4, .71 . 


General Description: Data-name-3, data-name-4, etc., 
must each be the subject of a record-description 
entry that has a level-number of 01. 

If the file contains more than one type of record, 
a different data name must appear for each type. 
Data-name order is not important. 

If one record is read from a given file and another 
is read from the same file, the second record replaces 
the first in the read-in area. Thus, if two records are 
needed for processing at the same time, the first rec- 
ord must be saved by moving it to another area of 
storage (such as a work area) before the second rec- 
ord is read. 

Example: Figure 21 shows a sample data record 
clause. In this example, recorda and recordb are 
both in the same file and are described in a record- 
description entry as level 01 records. 


Record-Description Entry 

General Description: The record-description entries 
in the cobol source program provide detailed infor- 
mation about each item of data that will be needed 
during the running of the object program. Each such 
item must have its own entry consisting of a level- 
number, a data-name, and a series of independent 
clauses. 


Reference Format 


level-number j 


FILLER 

data-name-1 



REDEFINES data-name-2 




SIZE IS integer-1 


( CHARACTER^] 
1 DIGITfS] 


^ OCCURS integer-2 TIME[S] 

r { T FFT ) *"""] 

POINT LOCATION IS \ ~ ~ [ integer-3 PLACE[S] 

RICjH 1 ) I 


L 


CLASS IS 


! ALPHABETIC \ 
NUMERIC f 

ALPHANUMERIC t 

an ; 


RT? T „ Any allowable combination of characters and 
1 1C 1 UnL IS S y m l)ols as described in Chapter 6 (cobol GI) 


[justified jjjjgy] 


ZERO SUPPRESS 
CHECK PROTECT 
FLOAT DOLLAR SIGN 


LEAVING integer-4 PLACE[S] 


[ 


“1 


BLANK WHEN ZERO J 


VALUE IS 
VALUES ARE 


| literal-1 [ THRU literal-2] 

[ THRU literal-4 ] . . 71 


General Description: The level-number shows the re- 
lationship between items in a record. 

The highest level is 01 and the lowest level is 49. 
Level 77 applies to n on-contiguous items of data that 
are elementary in themselves. Level 88 denotes a 
condition name and must appear immediately after 
the entry that describes the data name with which a 
condition name is associated. 

Each level number must be associated with a data- 
name or the key word filler, filler must describe 
items that appear in records but are not referred to 
within procedure statements. 
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DATA-NAME 

Complete Checking 

Partial Checking 

INPUT 

OUTPUT 

INPUT 

OUTPUT 

ID or 

IDENTIFICATION 

10 AN 

10 AN 

10 AN 

10 AN 

CREATION DATE 

5 N 




RETENTION-CYCLE 

3 N 

3 N 


3 N 

FILE-SERIAL- 

NUMBER 

* 5 N 

* 5 N 



REEL-SEQUENCE- 

NUMBER 

**3N 

** 3 N 




* The use of a FILE-SERIAL-NUMBER entry implies full 
label checking. 

** If not specified, 001 will be assumed. 


Figure 19. Data-Names and Lengths of Their Associated Literals 


Items must be written in the record-description 
entry in the same order in which they appear in the 
record. 


SIZE IS [integer-1 TO] 


integer-2 


( CHARACTER^] 
i DIGIT[S] 



[ DEPENDING ON data-name ] 

General Description: This clause tells the processor how 
many characters (or digits) the data item contains. 

This size is interpreted by the 1401 cobol proc- 
essor in terms of characters if either the optional 
word character[s] or digit[s] is used or if neither 
of the optional words is used. 

To specify the sizes of variable-length records, 
(form 4) integer-1 and integer-2 and depending on 
data-name must be used. Integer-1 specifies the num- 
ber of characters in the smallest record and integer-2 
specifies the number of characters in the largest rec- 
ord. depending on data-name identifies the elemen- 
tary items whose value is the record character count 
(refer to Record Character-Count Field). Integer-1 
and depending on data-name may be used only with 
form-4 records. 


Example: Figure 22 shows a size entry for a form-4 
record which can contain from 50 to 150 characters. 
reccount is the data-name the programmer has used 
to identify the RCC field. 

The size of fixed-length records is specified by 
using the form: 


SIZE IS integer-2 


( CHARACTER^] 
j DIGIT[S] 


where integer-2 is the exact number of characters 
contained in the record or item of data. 

Example: Figure 23 shows a size entry for a fixed- 
length record whose size is eighty characters. 


OCCURS integer-2 TIME[S] 




General Description: The occurs clause describes a 
sequence of data items of the same format. For ex- 
ample, if a rate table contains ten rates, each made 
up of five characters, fifty storage positions can be 
reserved for the rate table by using one occurs 
clause. An individual rate from this rate table can be 
referred to in the procedure division by subscripting 
the data-name assigned to the rates. The maximum 
number of positions that can be reserved by an 
occurs clause is 999. 

Example: Figure 24 shows how an occurs clause for a 
rate table may be coded. 

In the procedure division a statement using rate 
(2) as a subscripted data-name can refer to the sec- 
ond rate in the rate table (Figure 25). 

The occurs clause may not be used with an item 
whose level number is 01, 77, or 88. Integer-2 must 
be a positive numerical literal having an integral 
value greater than zero. 


( LEFT ) 

POINT LOCATION IS ] [ 

_ ( RIGHT S 


integer-3 PLACE[S] 




General Description: This clause describes the decimal 
point location for a number so that the processor can 
provide for the correct alignment of assumed decimal 
points during computation. It can be used only with 
an elementary item. Integer-3 must be a numerical 
literal with an integral value. 

Example: The point clause (Figure 26) causes an as- 
sumed decimal point to be located two positions to 
the left of the units position of the item whose data- 
name is grosspay (999V99). 

Note that the assumed decimal point is not in- 
cluded in the size of the item because it will not 
actually exist in 1401 core storage at program-execu- 
tion time. 


16 




! ALPHABETIC 
NUMERIC 
ALPHANUMERIC 
AN 

General Description: This clause tells the cobol proc- 
essor whether an item is numerical, alphabetic, or a 
combination of alphabetic and numerical characters 
with or without special characters (alphanumeric). It 
is required only if no picture clause is included in 
the source program. The class clause may describe 
both elementary and group items at any level. 

The sample problem shows cobol entries without 
either class or picture clauses. The 1401 cobol Proc- 
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Figurc 20. identification and Retention Cycle 


essor assumes items not specified by either of these 
clauses to be alphanumeric. 

numeric specifies an item that consists entirely of 
digits 0-9, and a plus or minus sign if one is neces- 
sary. 



Figure 21. data records 



Figure 22. size Variable Length 
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Figure 23. size Fixed Length 
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Figure 24. occurs 
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Figure 25. Subscripting 

alphabetic specifies an item that consists entirely 
of the letters of the alphabet and spaces. 

alphanumeric specifies an item that consists of 
any characters in the 1401 character set in any com- 
bination (all numeric, all alphabetic, or mixed). 
Example: Figure 27 shows a class clause that defines 
a numeric field of five digits with a sign over the 
units position. 

[ PICTURE T<% Any allowable combination of characters and 
symbols as described in Chapter 6 (cobol GI)\ 

General Description: The picture clause can describe 
elementary items. It can be used instead of the size, 
point, class, editing, and blank clauses of a record- 
description entry to state the characteristics of an 
item in a more compact form. 

The rules for forming a picture for a data item are 
given in the cobol General Information Manual. 
However, with 1401 cobol the S symbol for an op- 
erational sign should not be used, and the ele- 
mentary item generated from a picture clause 
must not exceed 999 positions of core storage. 
Example: The picture clause shown in Figure 28 de- 
scribes an item whose data name is 3C-one. The 


size of this field is five numeric characters with an 
asumed decimal point two places to the left of the 
units position. 

\ LEFT ) 

JUSTIFIED {— T (_ 

General Description: This clause specifies the position 
data is to occupy if it is moved during processing 
from one location to a larger location. 

If a justified clause is not included in the cobol 
source program, numerical items with be automati- 
cally right-justified (the data in the units position of 
the original location will be placed in the units posi- 
tion of the new location), and the unusued positions 
to the left will be filled with zeros. If a numerical 
data item includes an assumed decimal point, align- 
ment is made during the automatic justification. 

alphabetic and alphanumerical items will be 
left-justified (the data in the high-order position of 
the original location will be placed in the high-order 
position of the new location), and unused positions 
to the right will be filled with blanks. 

The justified clause permits the programmer to 
reverse the justification of an item (numerical items 
can be left- justified and alphanumerical items right- 
justified) except when an assumed decimal point has 
previously been specified for the item. 

Example: The numerical item deduct is eight charac- 




ters long. During processing, a six-character field is to 
be moved to deduct and is to be left- justified. Figure 
29 shows a justified clause that specifies that the 
data moved to the deduct field will be left- justified. 
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Figure 28. picture 

Special Editing Functions 

These cobol editing functions may be used only when 
the object computer is equipped with the expanded 
print-edil: feature: 

1. High-order CR or minus signs and high-order DB or 
plus signs. 

2. Floating plus and minus signs, and floating dollar 
signs. 

3. Check protection (asterisk fill). 

4. Decimal suppression for blank or zero fields. 
Editing of a single-digit field cannot be specified in 

editing or picture clauses. 

When the editing options for floating plus, minus, 
and dollar sign are used, more than two floating char- 
acters must be specified in the picture or editing 
clause. For example, if $$99 is specified, the $ will not 
float, but zero suppression will take place. However, if 
$$$9 is specified, the dollar sign will float and zero sup- 
pression will take place. 

If a group item is moved to an elementary item 
that requires editing, the diagnostic invalid use of 
editing will result. (A report item can only receive 
numeric data; the 1401 tape cobol compiler considers 
a group item as alphameric data.) 


zero suppress causes high-order zeros to be re- 
placed with blanks up to but not including the first 
non-zero digit or an assumed or actual decimal point 
encountered in a numerical item. 

When using zero suppression in either the picture 
clause or the editing clause, the high-order position 
must not be the only character specifying zero sup- 
pression. For example, Z9 is incorrect, but ZZ is 
correct. 

check protect causes all high-order zeros to be 
replaced with asterisks under the same conditions as 
ZERO SUPRESS. 

float dollar sign causes all high-order zeros to 
be blanked and a dollar sign to be placed to the left 
of the first significant character or decimal point. The 
editing clauses can be used only to affect zeros to the 
left of the decimal point. Zeros to the right of the 
decimal point must be cleared (if desired) by a 
blank clause. 

The leaving option restricts the suppression of 
zeros or insertion of asterisks and the dollar sign by 
specifying that a certain number of places (integer-4) 
to the left of the decimal point are to be undisturbed 
(unedited). 

Example: Figure 30 shows an editing clause that spec- 
ifies that high-order zeros are to be replaced with 
blanks. Assume that a field called fica is to be edited 
during processing in preparation for printing. If the 
value of the field moved to fica appears as 00508 
before editing, it will appear as 508 after editing. 
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Figure 30. Editing 


Editing Clauses 

~ (ZERO SUPPRESS 
<J CHECK PROTECT 

_ ( FLOAT DOLLAR SIGN 

^ LEAVING integer-4 PLACE[S]JJ 

General Description: This clause permits the program- 
mer to specify certain kinds of editing without using 
a picture clause. Only elementary numerical items 
may be described using the editing clause. 


j^ BLANK WHEN ZERO ~j 

General Description: This clause causes the described 
item to be filled with blanks whenever the value 
(contents) of the item field is zero. It can be used 
only with elementary items, blank when zero over- 
rides all editing specifications prescribed by a pic- 
ture or editing clause. 

Example: Figure 31 shows a blank when zero clause 
used with a float dollar sign clause. Without the 
blank when zero clause, a zero pay field would ap- 
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Figure 29. justified 
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Figure 31. blank when zero 

pear after editing as $.00. The blank when zero 
clause causes seven blanks to appear in the pay field 
when it is edited for printing. 

i VALUE IS ) 
t VALUES ARE 1 


General Description: A value clause can state the ini- 
tial contents ( value ) of a data item in the working- 
storage section or constant section. It can also be 
used with the thru option to define the value of a 
condition name (level-88 item) in the file section 
and WORKING-STORAGE SECTION. 

If the value clause is not used to define the initial 
values of working-storage items, their contents at 
program execution time will be unpredictable. 

If the value clause specifies a numerical literal, 
an operational sign will be developed (placed over 
the units position of the numerical field) only if the 
literal is preceded by a plus or minus sign. A figura- 
tive constant may be used in the value entry where 
a literal is specified. 


literal-1 [THRU literal- 2] literal-3 


lit 


[ THRU literal-4 ] 
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Figure 32. value 


The thru option is not described in the cobol 
General Information Manual. It may be used only 
with condition names as shown in Figure 32. 


^ REDEFINES data-name-2 

General Description: This clause permits the program- 
mer to redefine areas of storage that have been pre- 
viously defined by a record-description entry. 

Note the following additional points in connection 
with the use of redefines: 

1. If data-name-2 is not unique, it must be qualified 
by one or more additional names until it is unique. 

2. Data-name-2 must not be subscripted. 

Example: Figure 33 shows a redefines clause used to 

define a table of constants. 

The Constant and Working-Storage Sections 

The record-description entries described for the file 
section apply also to the constant and working- 
storage SECTIONS. 

These sections begin with the header line working- 
storage section or constant section and are followed 
immediately by the record-description entries. 

Added Elective Elements of the Data Division 

These elective elements of the record-description 
entry are not specified in the cobol General Informa- 
tion Manual, but are contained in the ibm 1401 cobol 
processor: 

1. The depending on data-name and the to integer-2 
options of the size clause. 

2. The thru literal-2 and the literal-3 thru literal-4 
options of the value clause. 

Deferred Elements of the Data Division 

The copy option is contained in the cobol General In- 
formation Manual, but is not contained in this version 
of the ibm 1401 cobol processor. 

The usage, signed, and synchronized clauses have 
no meaning in a 1401 cobol program and should not 
be used. 

A group mark should not be declared as an alpha- 
meric literal. 
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Figure 33. redefines 
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Procedure Division 


The procedure division is the operational part of the 
cobol source program. Once the data has been de- 
scribed, the programmer tells the cobol processor what 
steps the machine must take to read the input data, 
process it, and write it as output on punched cards, 
magnetic tape, or a printed form. 

The cobol verbs are the main elements in the pro- 
cedure division. They are described in detail in the 
cobol General Information Manual. However, some 
verbs have special meaning when used in a 1401 cobol 
source program. This additional information is pre- 
sented in the following section. 

The DISPLAY Verb 

General Description: The ibm 1403 Printer (1403-P) is 
the standard output unit for the display verb. PIow- 
ever, information may also be displayed via the ibm 

1402 Card Read-Punch (1402-P). As many printer 
lines or punched cards will be used as are necessary 
to display the information contained in the area of 
core storage whose data name is specified in the 
display statement. 

The object program initiates a skip to channel 1 in 
the carriage tape if a form overflow occurs in the 

1403 printer. If the display verb is used in the pro- 
cedure division to address the printer, the processor 
assumes that the printer will have a carriage tape 
with punches in channel 1 and 12 (overflow) at 
object-program execution time. 

Examples: The statement shown in Figure 34 will cause 
the contents of the area whose data name is grand- 
total to be displayed on the 1403 printer. 



Figure 34. printer display 

The statement shown in Figure 35 will cause the 
contents of grand-total to be punched into cards, 
if the mnemonic-name card punch has been as- 
signed to 1402-P in the special-names paragraph of 
the environment division. 



The ACCEPT Verb 

General Description: The ibm 1402 Card Read-Punch 
(1402-R) is the standard input unit for the accept 
verb. 

Example: Figure 36 shows an accept statement that 
will cause data to be read from the card reader and 
moved to an area whose data-name is cancella- 
tions. If more than eighty storage positions are de- 
fined by cancellations, multiple cards will be read 
from the 1402 until the area is filled. 



Figure 36. accept 


The WRITE Verb 


Reference Format 

WRITE record-name [ from area-name] 


( AFTER ) 

ADVANCING 

j integer LINES { 

1 BEFORE } 


\ mnemonic-name ) 


General Description: This statement causes a logical 
record to be released for an output file. 

Record-name is the name given to the record de- 
fined at the 01 level in the file section of the data 
division. Area-name is the name given by the pro- 
grammer to the core-storage area from which the 
record is to be written. 

The advancing option is used for spacing lines on 
output documents on the 1403 printer (1403-P). 

after and before in the advancing option control 
printer carriage spacing before or after the write 
verb is executed. Integer lines specifies how many 
lines should be spaced. Mnemonic-name is the name 
assigned in the special-names paragraph to a chan- 
nel in the carriage tape and is used when carriage 
skipping is desired instead of line spacing. The skip 
occurs to the line that corresponds to the specified 
punch in the carriage tape. 

Examples: Figures 37, 38, 39, and 40 show sample 
write statements. 
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Figure 35. punch display 


Figure 37. write 
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General Description: The examine verb is used to re- 
place a given character and/or to count the number 
of times it appears in a data item. 

Any literal used in an examine statement must be 
a member of the character set associated with the 
class specified for data-name. Thus, if the descrip- 
tion of data-name in the data division specifies a 
class that uses less than the full character set (nu- 
meric or alphabetic), then each literal used in an 
examine statement must be one of the characters in 
the restricted set. Thus, if the class of data-name is 
numeric, each literal used in the statement must be 
a numeric character. 


All literals in examine statements are considered 
alphanumeric, are one character in length, and are 
enclosed by quotation marks. When an examine 
statement is executed, the examination begins with 
the leftmost character of the data item and proceeds 
to the right. Each character in the item represented 
by the data-name is examined in turn. If the data 
item being examined is numeric, any operational 
sign associated with the item will be ignored. 

The effect of an examine statement depends on 
the options employed by the programmer as follows: 
If tallying is specified: 

A count of the number of certain characters in 
data-name is made when the tallying option is 
used. This count replaces the value of a special reg- 
ister called tally, which is accessible to the pro- 
grammer. The count depends on which of three op- 
tions of tallying is used: 

1. If all is specified, all occurrences of literal-1 in 
the data item are counted. 

2. If leading is specified, the count represents the 
number of times literal-1 occurs before a character 
other than literal-1 is encountered. 

3. If until first is specified, the count represents 
the number of characters that are encountered be- 
fore literal- 1 first occurs. 

If replacing is specified: 

The replacement of characters depends on which 
of the four options of replacing is used when the 
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replacing option is used either with or without the 
tallying option: 

1. If all is specified, literal-2 or literal-4 is substi- 
tuted each time literal-1 or literal-3 occurs. Literal-2 
is substituted for literal-1, and literal-4 is substituted 
for literal-3. 

2. If leading is specified, the substitution ends when 
a character other than the literal (literal-1 or literal-3 ) 
is encountered or when the rightmost character of 
the data item is reached. 

3. If until first is specified, the count represents the 
number of characters that are encountered before 
literal-1 first occurs. 

4. If first is specified, literal-3 is replaced by literal- 
4 only the first time literal-3 occurs. 

Example: Figure 41 shows a use of the examine verb. 

The ENTER Verb 

General Description: The enter verb permits the pro- 
grammer to use Autocoder statements in a cobol 
source program. 


The language name used with 1401 cobol is auto- 
coder. The Autocoder statements must be presented 
to the cobol processor immediately following the 
enter autocoder statement, and they must be fol- 
lowed by an enter cobol entry that indicates the 
point at which the cobol source language is resumed. 

Each enter autocoder statement must constitute 
a separate paragraph in the source program. The 
enter cobol statement used for returning to cobol 
from Autocoder must either constitute a separate 
paragraph or be the first entry of a paragraph. The 
name of the paragraph must be on the same line as 
the enter cobol statement. 

These specifications must be maintained when 
using Autocoder entries in a cobol program: 

1. Autocoder statements must be coded in Auto- 
coder format (label starting in column 6, operation in 
column 16, and operand in column 21). 

2. The symbols used in Autocoder statements must 
be five characters long. 



Figure 41. examine Verb 
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3. Autocoder statements can be written to refer to 
cobol names if they are related by entries in the 
special-names section of the cobol program. How- 
ever, cobol statements cannot be written to refer to 
Autocoder names. 

4. The word-mark status of a constant or area de- 
fined by a cobol statement must be the same aftei 
the Autocoder statements are executed in the object 
program as it was before they were executed. Thus, 
if it is necessary to write an Autocoder statement 
that sets or clears a word mark in such an area, the 
word-mark position of that area must be tested first 
so that the word mark can be reset or cleared before 
returning to the cobol program. 

5. No 1401 SPS statements can be included. 
Example: Figure 42 is an example that includes a sec- 
tion of Autocoder statements. 

6. Macro instructions may be given which refer to 
macros in the Autocoder library. 


The STOP Verb 

Reference Format 

(RUN ) 

22? t I 


General Description: This statement produces a 1401 
halt instruction which stops the execution of the 
object program. The run option of the stop verb 
causes an unconditional halt, and the program can- 
not be restarted. 

If the stop literal is numeric and within the range 
0-99, the literal 000-099 is displayed in the B-register 
if the halt occurs during the running of the object 
program. 
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Figure 42. enter Verb, Part 2 of 3 













If the stop literal is numeric and greater than 99 
or if it is alphanumeric, the address of the literal is 
displayed in the B-address register when an object- 
program halt occurs. 

Example: Figure 43 shows the stop statement. 
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Figure 43. stop Verb 

The OPEN and CLOSE Verbs 

The cobol language, as specified in the cobol General 
Information Manual, provides the ability to open an 
output file, process it, close it, and subsequently open 
it as an input file. It also provides for opening an input 
file, processing it, closing it, and subsequently opening 
it as an output file. These procedures are not handled 
by this version of the 1401 cobol processor, and are 
therefore classified as deferred elements. 


Exponents 

ibm 1401 cobol provides for integer or non-integer 
powers to be used in writing exponents. The sign of 
the power can be either plus or minus. Negative bases 
cannot be raised to other than an integer power. 

Conditional Statements 

Option 1 

IF conditional expression statement-1 . 


Option 2 


IF conditional expression 


OTHERWISE 

ELSE 


} 


( statement-2 \ 

4 NEXT SENTENCE ( 


statement-3 f 

NEXT SENTENCE | 


Option 3 


/ statement-4 AT END 1 ( statement-6 

\statement-5 ON SIZE ERROR j ) NEXT SENTENCE 


f OTHERWISE ) 

J statement-7 t 

( ELSE / 

| NEXT SENTENCE J 


any imperative statement-8 followed by any conditional 
statement-9 


Statement-1 under Option 1 can be only a simple or 
compound imperative statement. 

Statement-2 and/or statement-3 under Option 2 and 
statement-7 under Option 3 can be either imperative 
or conditional. If conditional, these statements can con- 
tain conditional statements in arbitrary depth. When 
conditional, the conditions within the conditional state- 
ments are nested. 

Statement-4 under Option 3 must be a read state- 
ment, statement-5 must be an arithmetic statement, 
and statement-6 can be only a simple or compound 
imperative statement. Statement-8 followed by state- 
ment-9 (to which the previous paragraph applies be- 
cause it is conditional) is an illustration of an impera- 
tive statement followed by a conditional statement. 
This is logically equivalent to statement-8 followed by 
a period followed by statement-9 beginning a new sen- 
tence. Option 3 in its entirety may be substituted for 
statement-2 and/or statement-3 under Option 2. 

An else or otherwise must be explicitly written for 
every conditional statement within a sentence. How- 
ever, the phrase else (otherwise) next sentence may 
be eliminated only if the phrase immediately precedes 
the period ending a sentence. 


Nested Conditional IF Statements 

The cobol programmer can combine several simple 
conditional statements into one by using a technique 
called nesting. The processor analyzes a nested state- 
ment by working from the inside to the outside of the 
statement. Thus, if all conditions are satisfied, the first 
imperative is executed; if all but the last condition are 
satisfied, the second imperative is executed, etc. 

Figure 44 shows outlines for four simple conditional 
statements. Figure 45 shows an outline for one nested 
conditional if statement that produces the same results 
as the four simple conditional statements shown in 
Figure 44. 

Figure 46 shows an excerpt from a cobol program 
in which four simple relational conditional expressions 
are substituted for the conditions shown in Figures 44 
and 45. 

The block diagram in Figure 47 shows the logic flow 
of the nested if statement in Figure 46. 


Added Elective Elements of the Procedure Division 

The advancing option of the write verb is not con- 
tained in the cobol General Information Manual, but 
is contained in the 1401 cobol processor. Conditional 
statements within conditional statements are permitted. 
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IF (condition 1) AND (condition 2) AND (condition 3) AND (condition 4) GO TO LAB4 ELSE NEXT SENTENCE 

IF (condition 1) AND (condition 2) AND (condition 3) GO IO LAB3 ELSE NEXT SENTENCE 

IF (condition 1) AND (condition 2) GO IO LAB2 ELSE NEXT SENTENCE 

IF (condition 1) GO TO LABI ELSE NEXT SENTENCE 

Figure 44. Four Conditional if Statements 


IF (condition 1) IF (condition 2) IF (condition 3) IF (condition 4) GO TO 

LAB4 ELSE GO TO LAB3 ELSE GO TO LAB2 ELSE GO TO LAB 1 ELSE NEXT SENTENCE 


Figure 45. Nested Conditional if Statements 



Figure 46. Nested Program Sample for Conditional if Statements 
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Figure 47. Conditional Logic 


Deferred Elements of the Procedure Division 

These elements are described in the cobol General, In- 
formation Manual but are not implemented by this 

version of the 1401 cobol processor: 

1. The reel option of the close verb. 

2. The corresponding option of the move verb ( elec- 
tive). 

3. The ability to process a given file as both an input 
file and an output file in the same program. 

4. The ability to use a group mark as an alphameric 
literal. 

5. The ability to use quote signs ( @ ) within a note 
statement. 
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General Information 


Character Sets 

ibm Character Set H must be used for source programs. 
This character set consists of the numerals 0 through 9, 
the 26 letters of the alphabet, and 12 special characters. 
The ibm 1401 character set may be used only for alpha- 
numeric literals. The following are cobol (Set H) spe- 
cial characters with their equivalents in the ibm 1401 
character set: 


Card Code 

COBOL 
( SET H ) 

1401 

Meaning 

blank 



space 

11 

- 

- 

j minus sign 
l hyphen 

12 

+ 

& 

plus sign 

0-1 

/ 

/ 

division sign 

11 - 4-8 

* 

* 

\ multiplication sign 
( check protection symbol 

12 - 4-8 

) 

□ 

right parenthesis 

0 - 4-8 

( 

% 

left parenthesis 

0 - 3-8 

9 

9 

comma 

11 - 3-8 

$ 

$ 

dollar sign 

12 - 3-8 



j period 
] decimal point 

3-8 

= 

# 

equal sign 

4-8 

' 

@ 

quotation mark 


Figurative Constants 

LOW-VALLIE(S) 

The value of this figurative constant is the space, or 
blank. The blank character is the lowest in the ibm col- 
lating sequence. 

HIGH-VALUE(S) 

This figurative constant is defined as the integer 9. The 
character 9 is the highest in the ibm collating sequence. 

QUOTE(S) 

This figurative constant is defined as the cobol char- 
acter (Set H) for the quotation mark. 

Additional COBOL Words 

The following words constitute an extension of the list 
of cobol words contained in the ibm General Informa- 
tion Manual describing cobol. id may be used in place 
of identification. The meaning and use of the other 
words have been described in this publication. 


advancing 

BEFORE 

LINES 

VALUES 

ID 

RETENTION-CYCLE 

TAPE 

TAPES 

NO-RELEASE 

NO-OVERLAP 

NO-PRINT-STORAGE 

1402-R 

1402- P 

1403- P 
1403-CT 
1403-P-CB 
1403-P-C9 
1403-P-CV 
1401-SS 

CREATION-DATE 

FILE-SERIAL-NUMBER 

REEL-SEQUENCE-NUMBER 


Class Conditions 

The general information manual specifies that the class 
of a data item is either numeric, alphabetic, or alpha- 
numeric. It further specifies that the class condition 
tests an alphanumeric item at object time to determine 
whether it is wholly numeric or wholly alphanumeric 
in content. 

The source statement beginning: 

IF FIELD-A IS NUMERIC . . . 

results in a character-by-character check of the value 
of field-a at object time. If an operational sign is pres- 
ent in the units position, the associated character will 
be interpreted as being numeric. Thus, —9 is inter- 
preted as minus 9, not as the letter R. 

IF FIELD-B IS ALPH ABETIC . . . 

results in a character-by-character check of the value 
of field-b at object time. If each character in field-b is 
alphabetic, the item is considered alphabetic. 

Example: The following table shows how the class of 
an item is interpreted by the processor, depending 
upon which of the class tests is specified. The table 
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shows the result (yes or no) for each test and for 
each of the specified ranges of X. The X-character 
is used in the picture clause. It represents any char- 
acter in the 1401 character set. 


x-Character 

If Numeric 

If Alphabetic 

0-9 

Yes 

No 

SPECIAL 

No 

No 

CHARACTERS 



SPACE 

No 

Yes 

A-R 

Yes (if units 

Yes 


position) 


S-Z 

No 

Yes 


Continuation of Alpha Literals 

Alphanumeric literals must be preceded and followed 
by quotation marks. If an alphanumeric literal must be 
continued, a continuation symbol ( — ) must appear in 
column7, and a quotation mark must appear in col- 
umn 12. If the last character of an alphanumeric literal 
appears in column 72, column 7 must contain a con- 
tinuation mark, and columns 12 and 13 must both con- 
tain quotation marks. 

Sample Problem 

Here is a sample problem that is representative of file 
maintenance applications. It is not a source program 
for a unique problem. 

The IDENTIFICATION, ENVIRONMENT, and DATA DIVI- 
SIONS are complete in themselves. The procedure divi- 


sion contains only one statement that relates to device- 
and switch-name entries in the environment division, 
and illustrates the advancing option of the write verb. 

Figures 48, 49, 50, 51, and 52 describe the 1401 con- 
figuration and input and output record formats for the 
problem. Figure 48 shows the configuration for the ob- 
ject-1401 system. Figure 49 shows the master input and 
output card record formats. Figure 50 is the master- 
record block format for the input and output tapes. 
Figure 51 is the new master-card record format. Figure 
52 is the form layout for the invoice. Figure 53 is the 
sample cobol program. 


New - Master - Record Master - Input - Record 



Invoice - Line Master - Output -Record 


Figure 48. ibm 1401 Object Machine Configuration 
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MASTER -INPUT OUTPUT RECORD FORMAT 



Figure 49. Master Input and Output Record Format 


MASTER- RECORD BLOCK FORMAT 
(Contains Ten Master - Input Output Records) 


Figure 50. Master Record Block Format 

NEW -MASTER -RECORD 


Col 1-10 

Col 11-25 


Col 26-42 

Col 43-57 

Col 58-67 

Col 68-77 

Col 




Col 31-42 




78-80 



Col 

Col 

Col 







26-30 

31-35 

36-42 





(10) 

(15) 

(5) 

(5) 

(7) 

(15) 

(10) 

(10) 

(3) 


Figure 51. New Master Card Format 


A ) Invoice - Header - Line 


INVOICE LINE 



B) invoice - Detail - Line 
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Qty 

Va 

vv 

w 
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> No 

♦>> 

I 

mm 


i 

m 

ffl 


Description 


( 20 ) 



Package and Size 


Prices 


Prices 



Extended 

Amount 

(7) 



C ) Totals 


MW 

Total 

Qty 


Total 

Weight 

7 

»;♦ 

V 

w 

V 

»;v 

»!♦!« 

Price - Totals 

Retail -Total Invoice - 

Total 

.*X*X*t*X*X*X*X**v**X*Xv«%%*< 
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(7) 
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Figure 52. Invoice Form Layout 

31 



















Figure 53. Sample cobol Program, Part 1 of 8 



Figure 53. Sample cobol Program, Part 2 of 8 
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Programming Considerations 


Notes 

Addition Notes 

When using the add verb (or when using a compute 
statement involving an add operation), the data- 
names being summed must be placed in order of as- 
cending decimal size in the statement. The smallest 
decimal field must be first followed by an equal or 
larger decimal field. 

Division Notes 

In order to ensure correct decimal alignment when 
using the divide verb with the giving option ( or when 
using a compute statement involving a divide opera- 
tion), the programmer must declare a result field, the 
decimal portion of which is no more than one position 
greater than the decimal portion of the dividend. Also, 
the rounded option will have no effect unless this rule 
is followed. 


Techniques 

cobol provides a convenient method of writing busi- 
ness-oriented programs. However, certain techniques 
can be used to produce more efficient machine lan- 
guage coding and increased compiling speed. 

The following considerations and suggestions are 
included to aid the programmer in obtaining a better 
1401 COBOL-generated program. Following the sug- 
gestions are two programs. The original program 
(Figure 54) requires approximately 2,800 positions of 
core storage. By applying a few of the suggestions to 
the second program (Figure 55) the core storage re- 
quirement is reduced to approximately 1,900 positions 
of core storage, representing a saving of 33 percent. 

The changed statements utilize redefinition, equal 
decimal alignment, alphabetic compare, and the dele- 
tion of a subroutine caused by the statement write 
salary-record from salaries (Figure 54, part 4 of 4, 
line 100). It is recommended that the programmer 
become familiar with these suggestions and apply 
them in the writing of 1401 cobol programs. 

Area Allocation in the Data Division 

The following rules govern when 1401 cobol sets 
word marks with data areas : 


1. Record areas (01 entries) always have a group 
mark with a word mark in the following position, 
and have a word mark in the high order position. 

2. Word marks will be set in the high order positions 
at the next level from the 01 entry. This will be 
02, or the next lower level if no 02 is present, unless 
occurs or redefinition is present. 

3. Subfields have word marks set only when their 
high order positions coincide with word marks set 
as in preceding item 2. 

4. A word mark is always set in the high order posi- 
tion at the 77 levels, but there is no group mark 
with a word mark set. 

5. No word marks are set for data fields within a 01 
entry which contains a redefines or an occurs, 
either at the 01 entry (implicit redefinition is 
allowable) or at any sublevel. 

If word marks are required but not present, they 
will be set continually and cleared for access to the 
field; this requires time and core. If word marks are 
present, they will be regenerated if removed. For ex- 
ample, if editing into a 02 area, a word mark will be 
reset each time. 

Tables 

Many programs require tables. Following are several 
considerations about table building and searching 
with 1401 cobol. 

1. Unless it is certain that a table will never change, 
the initial values in the table should not be estab- 
lished with the value clause. A better approach is 
to set up a card deck or tape file with one table 
entry and a sequence number on each record. 
Using the read verb, build up the table data dur- 
ing program initialization. This approach elimi- 
nates the need for recompilation or object-program 
patching in the event that the table changes in 
value or size. 

2. Before using the occurs clause and one or more 
levels of subscripting, weigh the alternate storage 
cost of naming each table entry and writing (for 
example ) : 

IF ARG - TAB-1 MOVE ENT-1 TO WORK AND GO TO 

FOUND. 

IF ARG = TAB-2 MOVE ENT-2 TO WORK AND GO TO 

FOUND. 

etc. 

The additional coding effort is offset by dividends 
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in execution speed for tables with as many as 30 or 
more entries. 

3. Define long tables as a set of shorter tables. A few 
if statements are enough to isolate the relevant 
position, which can then be moved to a work area 
where the final pinpointing of the correct entry 
can be done. The move should be between 01 level 
records. 

4. If the work area mentioned in the preceding item 
3 is n entries long where n is a power of 2 (such 
as 8 or 16), the if statements which are used can 
be written in such a way as to effect a binary 
search. In the case of a 16-entry work area, this 
technique can yield an answer after only four if 
statements. 

5. Sequential table searches require little program- 
ming effort and are efficient if the table can be 
arranged so that the most active items are at the 
beginning of the table. 

Move Verb 

1. move a to b, where A and B are equal length 
alphanumeric elementary items defined at either 
the 01 or 02 levels, gives the best possible coding. 
All items with subfields are treated as alpha- 
numeric by cobol, even if some or all subfields 
are defined as numeric. Only one 7 character in- 
struction is generated as long as A and B are not 
redefined or subscripted. 

2. If both A and B are redefined items or items de- 
fined at 03 levels and up, eight additional charac- 
ters of instructions are generated (i.e. set word 
MARK and CLEAR WORD MARK ) . 

3. Elementary items are treated as above unless they 
have an unequal number of decimal places. In 
that case, a total of 28 characters of instructions 
is generated. 

4. Unequal length elementary alphanumeric items 
are moved the same as equal length items when 
A is longer than B. However when B is longer, 11 
additional instruction characters are generated 
to blank the receiving field. 

5. When A and B are unequal length numeric items 
with identical scaling (same number of decimal 
places), 14 characters of coding are generated. 

6. move a to b causes 1401 cobol to include a spe- 
cial subroutine when A and B are of unequal 
length or one or both contain subfields. The spe- 
cial subroutine is used because the mlc and mcm 
instructions cannot conveniently handle this com- 
plex situation. Even when A and B are the same 
length, the subroutine is still used if A is a 01 
item and B is a 77 item or vice versa. The sub- 
routine may be avoided by writing a set of indi- 


vidual moves, redefining both A and B, or by 
making them the same length. 

7. move spaces to a and move zeros to a each 
generate 11 characters of object code unless A is 
a 01 level item with subfields. In that case, A can 
be redefined at an additional cost of eight charac- 
ters of object code. 

8. When editing is involved in move a to b, the 
same rules about scaling, redefinition, and size 
apply. For example, when the A field has fewer 
decimal places than the editing picture describ- 
ing B, many characters of coding are generated. 
If the scaling is identical for A and B, approxi- 
mately one-third as many instruction characters 
are generated, plus the 1401 edit word. 

9. Avoid editing functions which cannot be handled 
by the 1401 instruction set directly; cobol zeros, 
floating plus or minus, db, and single plus. A spe- 
cial subroutine is called to handle these cases. 

10. move all requires a special subroutine. Use a 
literal or constant of correct length to handle this 
case. 

If Statement 

1. When defining fields that are to be compared, con- 
sider the following: 

a. When at least one of the fields is a 01 item 
with subfields, a special subroutine is required. 

It is better to process such fields by comparing 
each lower-level item individually; or the group 
item can be moved to a hold area of equal size 
(not containing subfields), and then compar- 
ing. 

b. When numeric compares must be used because 
one or both of the fields are signed, attempt to 
arrange the record format so each item has the 
same number of decimal places. The fields do 
not have to be the same total length. 

2. In the statement if a =; b, only one of the fields 
(A or B) need be defined as alphanumeric to get 
the more efficient alphanumeric compare instruc- 
tions generated. 

3. if a not greater than b . . . has the same meaning 
as if a less than b or equal to b . . . and the gen- 
erated instructions for the first statement require 
half the number of core positions. 

4. The statement if a is zero . . . generates more 
efficient coding when A is defined as numeric 
rather than alphanumeric. However, an even 
greater improvement can be gained by declaring a 
constant of zeros (named C, for example), and 
writing if a = c . . . which is twice as fast. 

5. Avoid the statements if a alphabetic and if a 
numeric whenever possible because they require 
subroutines in the object program. 
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6. Avoid the use of all, high-values, low-values, 
spaces, and zeros in conditional expressions. They 
can easily be replaced by named constants. 

7. Subscripted names in an if statement will cause 
the compiler to include appropriate subroutines 
which often perform slowly at object time. Fre- 
quently it is better to use several if statements to 
perform a table look-up on a short table rather 
than use subscripting and the perform verb ( or an 
equivalent loop). 

Arithmetic Verbs 

1. Avoid on size error . . . whenever possible. The 
generated coding to perform this test consists of 
up to 30 characters. 

2. rounded usually generates about 21 additional 
characters of object code. 

3. add and subtract statements : 

a. The most efficient object coding is obtained 
for fields which have equal scaling. When two 
fields (A and B) have equal scaling, the state- 
ment add a to b generates 7 characters of ob- 
ject code. 

b. Redefining, or using 03 levels or greater, will 
require 8 additional characters for each field so 
defined. 

c. Multiple operands are as efficient as the equiva- 
lent set of single statements, add a, b to c gen- 
erates 14 characters (assuming the require- 
ments of 3a are met). 

d. add a to a is an economical way of multiplying 
A by two. Other sequences of add’s and sub- 
tract’s, sometimes with redefine’s to achieve 
a shift, can be devised to simulate a more com- 
plex multiplication. 

4. multiply and divide statements: 

a. multiply a by b giving c generates 21 characters 

of instructions if A, B, and C have no decimal 
places. When A, B, and C have decimals, and 
the number of decimals in C is not the sum of 
those in A and B, 42 characters of instructions 
are generated. 

b. In the preceding example, rounded generates 
an additional 7 characters. 

c. Less efficient coding is generated for a com- 
pute statement than for the equivalent set add, 
subtract, multiply, and divide statements. 
The reason for this is the need to retain up to 
18-digit precision throughout the execution of a 
compute statement. Because the 18 digits can 
be on either side of the decimal point, and be- 
cause one or two extra digits may be required 
for rounding, 1401 cobol allocates 40 digit ac- 
cumulators for the storage of temporary results. 


For example, compute a rounded = 

( B * C * D — E) / F, with a varying amount 
of decimal places, generates about 160 charac- 
ters of instructions plus 3 X 40 = 120 positions 
of temporary accumulators. For the equivalent 
multiply, subtract, divide sequence a total of 
about 140 positions of storage are used for the 
instructions and fields. 

Work areas are assigned only once per pro- 
gram. Thus the most complex compute state- 
ment determines the number of 40 character 
areas that will be needed for all compute’s. 

Perform and Alter Statements 

1. The statement alter label to proceed to next- 
label generates 10 characters of coding. 

2. The statement perform calculation generates 18 
characters of coding at the point in the program 
where the perform occurs. In addition, calcula- 
tion is augmented by 4 positions for each perform 
which references it. 

3. calculation should be positioned in the source 
program at the point where it will be executed 
most frequently simply by falling through from 
the preceeding paragraph. 

4. The option 2 statement, perform calculation 5 
times is efficient. Core requirements are about 45 
positions at the point in the program where the 
perform occurs and 4 positions additional at the 
end of calculation. No additional core or time is 
required when a data-name instead of a literal is 
used to indicate the number of times. 

5. Option 4 of the perform verb is handled best if 
the varying field is defined as alphanumeric and 
each of the fields in the expression has the same 
length. 

Input/Output Verbs 

1. The statements read into and write from each 
cause a move of the entire logical record. In many 
cases the use of these options is unnecessary be- 
cause processing can be done either in an input or 
an output record area as defined by the data rec- 
ords are clause in the fd’s. When read into or 
write from must be used, ensure that the implied 
data move involves equal length areas. 

2. When using a card reader, read is faster and gen- 
erally smaller than accept. Similarly, write is 
better than display for printing and punching. 

3. It is not possible within cobol to assign the same 
input/output area to two files. Areas in the work- 
ing-storage section can be ( and should be ) 
shared, however. 
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4. For card and printer files, input/output areas in 
addition to 001-080, 101-180, and 201-332 are as- 
signed. This is in anticipation of a possible conflict 
with the accept and display verbs, which use 
those areas also. 

5. The write verb for a printer fd does not clear the 
print area. Use move spaces to clear this area. 

6. Form 3 (unblocked, variable length) tape records 
are not permitted within 1401 cobol. If necessary 
the file can be defined as Form 1, and a simple 
Autocoder sequence can be used to set and clear 
the gmwm at the end of the portion of data to be 
written. Form 4 usually offers better tape utiliza- 
tion. 

7. In order to change the date specified for an input 
file for label checking purposes, enter autocoder 
and issue a rdlin iaxx macro. If the file is the nth 
fd in the program, then xx = n-(-9+m where 
m is the number of Autocoder names in the 
special-names section. 

8. A common error in cobol programming is the 
assumption that a different area in working- 
storage must be defined for each record type in a 
given file. This may be avoided by ( 1 ) defining all 
possible data records directly under the fd with 
one 01 entry group per record type, or ( 2 ) defining 
the most common record type under the fd and all 
the others in a single area in working-storage 
which is redefined once for each record type. 


Object Time Subroutines 

There are several cobol object time subroutines that 
may be generated. These routines are described in a 
separate bulletin which may be obtained with the pro- 
gram. Normally, the programmer should avoid cobol 
statements which cause these subroutines to be used. 
For the most part their inclusion is caused by either 
unusual language features or by complex data formats. 
Following is a list of these subroutines and the reason 
why they are called and/ or how they may be avoided. 

1. The Examine subroutine is included whenever 
the examine verb is used. It may be avoided as 
follows: 

a. For short fields, give each position a name by 
defining an appropriate number of subfields 
and using a set of if statements. 

b. For long fields, define a work area with one- 
character subfields and process portions of the 
long field there. 

2. Single, double, and triple subscript subroutines 
are included whenever a field is singly, doubly, 
or three-level subscripted. 


3. The Alpha Compare subroutine is included when 
a group item with subfields is compared to any 
data item. The subroutine may be avoided by 
redefining the field which contains subfields. 

4. The Figcon Compare subroutine is included 
whenever a record with subfields is compared to 
a figurative constant (high-value, low-value, 
quote, and all alpha-literal). This subroutine 
may be avoided by redefining the field with sub- 
fields and using a literal or constant (Figure 54). 

5. The If Numeric subroutine is included whenever 
an alphanumeric field whose size is greater than 1 
is tested for a numeric value. 

6. The If Alphabetic subroutine is included when- 
ever an alphanumeric field whose size is greater 
than 1 is tested for an alphabetic value. 

7. The Accept subroutine is included whenever the 
accept verb is used. To avoid this subroutine, 
define a file and use the read verb. 

8. The Display subroutine is included whenever the 
display verb is used. To avoid this subroutine, 
define a file and use the write verb. 

9. The Editing subroutine is included when editing 
requirements include cobol zero, floating -f- and 
— sign, single plus, and DB. It produces highly 
specialized editing features. If possible, use only 
the standard editing features of the 1401. 

10. The Exponentiation- 1 subroutine is included 
whenever an integer exponent is used (compute 
A — B * *5). It may be avoided by writing succes- 
sive multiply’s. 

11. The Go To Depending subroutine is included 
whenever go to depending is used. This sub- 
routine may be avoided by a set of if statements. 

12. The Move All subroutine is included when the 
all option of the move verb is used, a move 
statement or a set of move statements is prefer- 
able. 

13. The Move Record subroutine is included when- 
ever a record with subfields is used in a move 
statement, except when the other field is a record 
(01 level) of equal length. This subroutine may 
be avoided by: 

a. Using a set of elementary move’s. 

b. Redefining both fields to eliminate word 
marks. 

14. The Exponentiation-2 subroutine is included 
when raising an expression by a non-integral ex- 
ponent (compute a = b**2.5). It is impossible 
to perform all the functions of this subroutine 
with other cobol statements unless the exponent 
is defined as an integer. For special purposes an 
Autocoder subroutine may be a more practical 
solution. 
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□ 

Instructor 

□ 

Operator 
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Sales Representative 

□ 

Programmer 

□ 

Systems Engineer 
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Trainee 

□ 

Trainee 
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Other 


Other 
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